<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkProgress</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkPreview.html" title="GtkPreview">
<link rel="next" href="GtkText.html" title="GtkText">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkPreview.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
<td><a accesskey="n" href="GtkText.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkProgress.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#GtkProgress.description" class="shortcut">Description</a>
                   | 
                  <a href="#GtkProgress.object-hierarchy" class="shortcut">Object Hierarchy</a>
                   | 
                  <a href="#GtkProgress.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                   | 
                  <a href="#GtkProgress.properties" class="shortcut">Properties</a>
</td></tr>
</table>
<div class="refentry">
<a name="GtkProgress"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkProgress.top_of_page"></a>GtkProgress</span></h2>
<p>GtkProgress — Base class for GtkProgressBar</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkProgress.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="GtkProgress.html#GtkProgress-struct" title="struct GtkProgress">GtkProgress</a>;
<span class="returnvalue">void</span>                <a class="link" href="GtkProgress.html#gtk-progress-set-show-text" title="gtk_progress_set_show_text ()">gtk_progress_set_show_text</a>          (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_text</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkProgress.html#gtk-progress-set-text-alignment" title="gtk_progress_set_text_alignment ()">gtk_progress_set_text_alignment</a>     (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> x_align</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> y_align</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkProgress.html#gtk-progress-set-format-string" title="gtk_progress_set_format_string ()">gtk_progress_set_format_string</a>      (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkProgress.html#gtk-progress-set-adjustment" title="gtk_progress_set_adjustment ()">gtk_progress_set_adjustment</a>         (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkProgress.html#gtk-progress-set-percentage" title="gtk_progress_set_percentage ()">gtk_progress_set_percentage</a>         (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> percentage</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkProgress.html#gtk-progress-set-value" title="gtk_progress_set_value ()">gtk_progress_set_value</a>              (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="GtkProgress.html#gtk-progress-get-value" title="gtk_progress_get_value ()">gtk_progress_get_value</a>              (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkProgress.html#gtk-progress-set-activity-mode" title="gtk_progress_set_activity_mode ()">gtk_progress_set_activity_mode</a>      (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> activity_mode</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="GtkProgress.html#gtk-progress-get-current-text" title="gtk_progress_get_current_text ()">gtk_progress_get_current_text</a>       (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="GtkProgress.html#gtk-progress-get-text-from-value" title="gtk_progress_get_text_from_value ()">gtk_progress_get_text_from_value</a>    (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="GtkProgress.html#gtk-progress-get-current-percentage" title="gtk_progress_get_current_percentage ()">gtk_progress_get_current_percentage</a> (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             <a class="link" href="GtkProgress.html#gtk-progress-get-percentage-from-value" title="gtk_progress_get_percentage_from_value ()">gtk_progress_get_percentage_from_value</a>
                                                        (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkProgress.html#gtk-progress-configure" title="gtk_progress_configure ()">gtk_progress_configure</a>              (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> min</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> max</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="GtkProgress.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----GtkProgress
                           +----<a class="link" href="GtkProgressBar.html" title="GtkProgressBar">GtkProgressBar</a>
</pre>
</div>
<div class="refsect1">
<a name="GtkProgress.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkProgress implements
 AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkProgress.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkProgress.html#GtkProgress--activity-mode" title='The "activity-mode" property'>activity-mode</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  "<a class="link" href="GtkProgress.html#GtkProgress--show-text" title='The "show-text" property'>show-text</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  "<a class="link" href="GtkProgress.html#GtkProgress--text-xalign" title='The "text-xalign" property'>text-xalign</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
  "<a class="link" href="GtkProgress.html#GtkProgress--text-yalign" title='The "text-yalign" property'>text-yalign</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write
</pre>
</div>
<div class="refsect1">
<a name="GtkProgress.description"></a><h2>Description</h2>
<p>
A <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> is the abstract base class used to derive
a <a class="link" href="GtkProgressBar.html" title="GtkProgressBar"><span class="type">GtkProgressBar</span></a> which provides a visual representation of
the progress of a long running operation.
</p>
</div>
<div class="refsect1">
<a name="GtkProgress.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkProgress-struct"></a><h3>struct GtkProgress</h3>
<pre class="programlisting">struct GtkProgress;</pre>
<p>
The <a class="link" href="GtkProgress.html#GtkProgress-struct" title="struct GtkProgress"><span class="type">GtkProgress</span></a> struct contains private data only.
and should be accessed using the functions below.
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-set-show-text"></a><h3>gtk_progress_set_show_text ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_progress_set_show_text          (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_text</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_set_show_text</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Controls whether progress text is shown.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>show_text</code></em> :</span></p></td>
<td>a boolean indicating whether the progress text
is shown.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-set-text-alignment"></a><h3>gtk_progress_set_text_alignment ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_progress_set_text_alignment     (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> x_align</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> y_align</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_set_text_alignment</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Controls the alignment of the text within the progress bar area.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x_align</code></em> :</span></p></td>
<td>a number between 0.0 and 1.0 indicating the horizontal
alignment of the progress text within the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y_align</code></em> :</span></p></td>
<td>a number between 0.0 and 1.0 indicating the vertical
alignment of the progress text within the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-set-format-string"></a><h3>gtk_progress_set_format_string ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_progress_set_format_string      (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_set_format_string</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets a format string used to display text indicating the
current progress.  The string can contain the following substitution characters:
</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem"><p>
%v - the current progress value.
</p></li>
<li class="listitem"><p>
%l - the lower bound for the progress value.
</p></li>
<li class="listitem"><p>
%u - the upper bound for the progress value.
</p></li>
<li class="listitem"><p>
%p - the current progress percentage.
</p></li>
</ul></div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
<td>a string used to display progress text, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
to restore to the default format.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-set-adjustment"></a><h3>gtk_progress_set_adjustment ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_progress_set_adjustment         (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> *adjustment</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_set_adjustment</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Associates a <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> with the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.  A <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>
is used to represent the upper and lower bounds and the step interval
of the underlying value for which progress is shown.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>adjustment</code></em> :</span></p></td>
<td>the <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a> to be associated with the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-set-percentage"></a><h3>gtk_progress_set_percentage ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_progress_set_percentage         (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> percentage</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_set_percentage</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the current percentage completion for the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>percentage</code></em> :</span></p></td>
<td>the percentage complete which must be between 0.0
and 1.0.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-set-value"></a><h3>gtk_progress_set_value ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_progress_set_value              (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_set_value</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Sets the value within the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> to an absolute value.
The value must be within the valid range of values for the
underlying <a class="link" href="GtkAdjustment.html" title="GtkAdjustment"><span class="type">GtkAdjustment</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>the value indicating the current completed amount.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-get-value"></a><h3>gtk_progress_get_value ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             gtk_progress_get_value              (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_get_value</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the current progress complete value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the current progress complete value.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-set-activity-mode"></a><h3>gtk_progress_set_activity_mode ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_progress_set_activity_mode      (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> activity_mode</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_set_activity_mode</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
A <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> can be in one of two different modes: percentage
mode (the default) and activity mode.  In activity mode, the
progress is simply indicated as activity rather than as a percentage
complete.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>activity_mode</code></em> :</span></p></td>
<td>a boolean, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for activity mode.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-get-current-text"></a><h3>gtk_progress_get_current_text ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gtk_progress_get_current_text       (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_get_current_text</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the current text associated with the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.  This
text is the based on the underlying format string after any substitutions
are made.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the text indicating the current progress.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-get-text-from-value"></a><h3>gtk_progress_get_text_from_value ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gtk_progress_get_text_from_value    (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_get_text_from_value</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the text indicating the progress based on the supplied value.
The current value for the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> remains unchanged.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>an absolute progress value to use when formatting the progress text.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a string indicating the progress.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-get-current-percentage"></a><h3>gtk_progress_get_current_percentage ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             gtk_progress_get_current_percentage (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_get_current_percentage</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the current progress as a percentage.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a number between 0.0 and 1.0 indicating the percentage complete.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-get-percentage-from-value"></a><h3>gtk_progress_get_percentage_from_value ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>             gtk_progress_get_percentage_from_value
                                                        (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_get_percentage_from_value</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Returns the progress as a percentage calculated from the supplied
absolute progress value.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>an absolute progress value.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>a number between 0.0 and 1.0 indicating the percentage complete
represented by <em class="parameter"><code>value</code></em>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-progress-configure"></a><h3>gtk_progress_configure ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_progress_configure              (<em class="parameter"><code><a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a> *progress</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> value</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> min</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> max</code></em>);</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gtk_progress_configure</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Allows the configuration of the minimum, maximum, and current values for
the <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>progress</code></em> :</span></p></td>
<td>a <a class="link" href="GtkProgress.html" title="GtkProgress"><span class="type">GtkProgress</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>the current progress value.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>min</code></em> :</span></p></td>
<td>the minimum progress value.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
<td>the maximum progress value.</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1">
<a name="GtkProgress.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkProgress--activity-mode"></a><h3>The <code class="literal">"activity-mode"</code> property</h3>
<pre class="programlisting">  "activity-mode"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>If TRUE, the GtkProgress is in activity mode, meaning that it signals something is happening, but not how much of the activity is finished. This is used when you're doing something but don't know how long it will take.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkProgress--show-text"></a><h3>The <code class="literal">"show-text"</code> property</h3>
<pre class="programlisting">  "show-text"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>Whether the progress is shown as text.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkProgress--text-xalign"></a><h3>The <code class="literal">"text-xalign"</code> property</h3>
<pre class="programlisting">  "text-xalign"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
<p>The horizontal text alignment, from 0 (left) to 1 (right). Reversed for RTL layouts.</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0.5</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkProgress--text-yalign"></a><h3>The <code class="literal">"text-yalign"</code> property</h3>
<pre class="programlisting">  "text-yalign"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a>                : Read / Write</pre>
<p>The vertical text alignment, from 0 (top) to 1 (bottom).</p>
<p>Allowed values: [0,1]</p>
<p>Default value: 0.5</p>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>